Contents

A Tutorial Introduction
What is Literate Programming?
What is FunnelWeb?
The Name FunnelWeb
A FunnelWeb Tutorial
A Hello World Document
Macro Facilities
Simple Macros
Number of Times Called
Indentation
Additive Macros
Parameterized Macros
Macro Expansion
Include Files
Typesetting Facilities
Overview
Typesetter Independence
Hierarchical Structure
Understanding the Printed Documentation
Literals and Emphasis
Adding a Header Page
Comments
A Complete Example
Summary

FunnelWeb Hints
Macro Names
Quick Names
FunnelWeb the Martinet
Fiddling With End of Lines
Fudging Conditionals
Changing the Strength of Headings
Efficiency Notes
Interactive Mode
Setting Up Default Options
FunnelWeb and Make
The Dangers of FunnelWeb
Wholistic Debugging
Examples of FunnelWeb Applications
Analyzing the Monster Postscript Header File
Making Ada ADTs more A
Multiple Language Systems
The Case of the Small Function
When Comments are Bad
Documents That Share Text
Generics
Summary

FunnelWeb Definition
Introduction
Notation
Terminology
An Architectural Overview
Diagnostics
Typesetter Independence
Command Line Interface
Invoking FunnelWeb
Command Line Arguments
Options
File Name Inheritance
FunnelWeb Startup
Scanner
Basic Input File Processing
Special Sequences
Setting the Special Character
Inserting the Special Character into the Text
Inserting Arbitrary Characters into the Text
Comments
Quick Names
Inserting End of Line Markers
Suppressing End of Line Markers
Include Files
Pragmas
Freestanding Typesetter Directives
Scanner/Parser Interface
Parser
High Level Structure
Free Text
Typesetter Directives
Macros
Expressions
Macro Calls
Formal Parameters
Macros are Static
Analyser
Tangle
Weave
Target Typesetter
Cross Reference Numbering
FunnelWeb Shell
Introduction
Return Statuses
Command Line Length
String Substitution
How a Command Line is Processed
Options
Shell Commands
Concluding Remarks

FunnelWeb Installation
Obtaining a Copy of FunnelWeb
Establishing The Directory Tree
Admin Directory
Answers Directory
Hackman Directory
Results Directory
Scripts Directory
Sources Directory
Tests Directory
Userman Directory
Compiling FunnelWeb
Testing FunnelWeb
Installing FunnelWeb
Printing Manuals
Installation Problems?

FunnelWeb Administration
Introduction
The User's Commitment To FunnelWeb
Documentation
Registration
Support
Copyright
Nowarranty
Distribution
Modification
Versions
FTP Archive and Author

Glossary
References
Index